home *** CD-ROM | disk | FTP | other *** search
/ Merciful 5 / Merciful - Disc 5.iso / software / p / personalpaint7.lha / PPaint / libs / PBlit_68K.readme < prev    next >
Encoding:
Text File  |  1997-04-19  |  3.6 KB  |  97 lines
  1. Short:        Personal 68K Blit Libraries v. 2.1
  2. Uploader:     info@cloanto.com (Cloanto)
  3. Author:       info@cloanto.com (Cloanto)
  4. Type:         biz/cloan
  5. Distribution: Only Cloanto, Aminet and Aminet CD-ROM
  6.  
  7.  
  8. CLOANTO SOFTWARE UPDATE
  9.  
  10.  
  11. FILES BEING UPDATED
  12.  
  13.   - personal_68000_blit.library
  14.   - personal_68020_blit.library
  15.  
  16.  
  17. PROGRAMS USING THE LIBRARIES
  18.  
  19.   - Personal Paint version 7.0 and higher
  20.   - ColorType version 3.1 and higher
  21.  
  22.  
  23. INSTALLATION DIRECTORY
  24.  
  25.   - Default   : "PPaint:libs", "ColorType:libs"
  26.   - Optionally: "LIBS:"
  27.   (software checks both paths and uses the newer library if two are found)
  28.  
  29.  
  30. ENVIRONMENT VARIABLES
  31.  
  32.   - PBlit_ChipMem (Yes/No/Auto)
  33.  
  34.  
  35. DESCRIPTION
  36.  
  37. The CPU blitting libraries are used by programs like Personal Paint when
  38. the "Settings/Graphics/Amiga Blitter" setting is switched off.
  39.  
  40. These libraries automatically detect a CyberGraphX 40.100+ environment,
  41. and inform the client software (e.g. Personal Paint) that it is safe to
  42. allocate Fast RAM instead of Chip RAM even if the memory has to be
  43. accessed by the graphics.library. CyberGraphX "clones", which have a
  44. parallel system of version numbers, are detected and will not trigger
  45. this condition, as this would currently crash the system.
  46.  
  47. These libraries use the 68K CPU to emulate a 32-bit blitter, whereas the
  48. libraries prior to version 2.0, like the original Amiga, worked with a
  49. 16-bit blitter model. This release is about twice as fast as the 1.x
  50. libraries.
  51.  
  52. Additional functionality has been integrated in these libraries to
  53. better support future programs.
  54.  
  55. The 68020 library is slightly faster than the 68000 version. To use the
  56. 68020 version, please edit the library name in the "Startup_1.set"
  57. program settings file. In no case should the library files be renamed. It
  58. is sufficient to install one of the two 68K libraries.
  59.  
  60. These libraries are mainly useful on blitterless systems such as the
  61. DraCo, or on systems where the original blitter cannot access the image
  62. bitmaps (for example, because they are in Fast RAM).
  63.  
  64. In theory, when using a blitter emulation library rather than the
  65. "personal_agnus_blit.library", Cloanto programs like Personal Paint can
  66. work without Chip RAM. However, Personal Paint also uses the system
  67. "graphics.library", which for most functions (e.g. Flood(), AreaDraw(),
  68. etc.) can only access bitmaps in Chip RAM (not in Fast RAM). As these new
  69. 68K blitting libraries are being released, only the original CyberGraphX
  70. software from version 40.100 went as far as to replace all Amiga system
  71. functions so that they can be applied to Fast RAM.
  72.  
  73. The Cloanto "PBlit_ChipMem" environment variable, originally designed for
  74. development and testing purposes, can be used to force programs like
  75. Personal Paint not to use Chip RAM when system graphics.library
  76. replacements are used that are not detected automatically by these
  77. libraries. However, if the system graphics.library does not fully support
  78. bitmaps in Fast RAM, it is likely to crash as soon as a system function
  79. requiring Fast RAM is used by Personal Paint.
  80.  
  81. The libraries included here use and instruct Personal Paint to use (or
  82. not to use) Chip RAM as indicated by the "PBlit_ChipMem" environment
  83. variable. If the variable is not set, the choice is made automatically by
  84. the library based on a series of scans and test allocations.
  85.  
  86.  
  87. NOTES
  88.  
  89. Your feedback is very appreciated. E-mail: <support@cloanto.com>.
  90.  
  91. Visit our web site at <http://www.cloanto.com> for the latest news.
  92.  
  93. For additional technical and legal information on the files, please refer
  94. to the documentation included with the original (commercial)
  95. distribution. In particular, all files are Copyright © 1996, 1997 Cloanto
  96. Italia srl.
  97.